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Sir: 

I, Mark J. Flanagan, inventor for the invention claimed in the above referenced patent 
application, declare as follov^s: 

Sometime prior to December 1, 2001, 1 conceived and reduced to practice: 

a review facility for providing an item, such as a document (e.g., source code), for review by a 

plurality of reviewers, e.g., in a development group, and collecting comments from reviewers, 

a method of reviewing items in the review facility, 

and a program product embodying the review facility; 
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My review facility included: 

preparation means for preparing an item for interactive review, 

means for collecting comments on elements (e.g., lines in the document) of prepared items; and 
means for distributing collected comments from review; 

The review facility also included means for making prepared items available for interactive 
collaborative review; 

The review facility identifies individual elements within an item with reviewers providing 
comments on individual elements; 

Particular individual elements may be block of text, e.g., individual lines of said source code; 

Sometime prior to December 1, 2001, my invention was reduced to practice and memorialized in 
an MS Word file, a hardcopy of which is attached hereto and marked Exhibit A; 

Sometime prior to December 1, 2001, 1 printed the contents of the MS Word file and submitted it 

as Siemens Corporation Invention Disclosure, a copy of the cover page, the first and last pages of 
which are attached hereto, the conception date and personal information having been redacted as 
indicated and marked Exhibit B; 

On January 9, 2002, the present patent application was filed embodying my invention; 

All acts, including conception and reduction to practice, occurred in the United States; 

I fiirther declare that all statements made herein of my own knowledge are true and that all 
statements made on information and belief are believed to be true; and 
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I further declare that these statements were made with the knowledge that willful false statements 
and the like so made are punishable by fine or imprisonment, or both, under Section 1001 of 
Title 18 of the United States Code, and that such willfiil false statements may jeopardize the 
vahdity of the application or any patent issued thereon. 

Inventor: Mark J. Flanagan 



Signature: 
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Residence: 



8735 Indian River Run 
Boynton Beach, FL 33437 



Citizenship: U.S. 



Post Office Address: Same as above 
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SIEMENS eONFipENtlAL 1 
Invention Disclosure Form Supplement 

1. Title : WebReview 



2. Abstract: 

WebReview provides for inspection and review of software products (source code) 
lising a .cbilaboratiVe, interactive facility. 



3. Background Information 

a. What is the problem solved bv vour invention ? 

Code Inspections are ari integral part of our software development processes. 
Currently^ a static packet is created by the author or moderator assigried to the 
review which is distributed to all. reviewers. Aflier a suitable "review period, a 
meeting is held where an assigned developer reads the code out loud :and 
reviewers make comments and idientify errors or problems ^ These are recorded by 
the assigned moderator and corrected by the author, completing the review 
process. 

b- What techniques prior to your invention were used to perform the function of 
vour invention ? 

1) Manual inspections — generally on paper, in accordance with software 
development process guidelines . 

2) 

c . What are the disadvantages of these prior techniques? 

The review/inspection meeting(s.) generally take a great deal of time,, current 
inspection guidelines use a metric of 100-125 lines of code per hour of meeting 
with similar times required for preparation and correction times. 

d. What are the advantages of vQuf invention over the prior techniques ? 

Qn-iihe review, with collaborative collection of information should be much more 
efficient. Reviewers receive information from each other during the preparation 
process so the review meeting should be much shorter. Since the comments are 
available immediately, the author and moderator can agree on the clarity and 
correctness of most comments and eliminate the need for discussion. 



Witness: 
Date: 
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Detailed Description 

Detailed structural, and functional operation : 
This process consists of three operations: 

1.. Preparing the Web Review for the item under consideration. This involves 

formatting the item to be inspected with unique identification of each, element 
(i.e. source code line), gathering the elements of the iteixi (i.e. source files j 
into a known location, and, constructing the initially^empty collected 
comments. 

2. Inspecting or reviewing the item under consideration. This involves two 
classes of activities: 

a. The collaborators examine^ in detail,;the item using the WebReview 
server and individual equipment-(e.g. a web -browser). As comments, 
questions, and errors are noted 'by individuals, they provide their 
remarks to the WebReview server; These comments, are then made, 
avaiilable to all other collaborators, identified by the inspector and the 
item (e.g. source code file and line number) where they apply. 

b. The WebReview server provides the collaborators with th^ prepared 
elemients of the item and accepts remarks from individuals. The 
remarks are gathered and provided^ to any collaborator on deniand. 

3. Executing the formal review meeting using products of the WebReview 
process^ This uses the collective remarks entered during the review by all 
collaborators. The atithor and moderator will generally agree, that some 
(usually most) of the remarks are clear and! obvious and do not require 
additional information. UisUally, a few remarks remain and a (brief) meeting 
among the collaborators is used to plarify aiid discuss the specific areas of 
concern. 

Are there alternative methods or different structural embodiments of your 
invention? Gan the general idea or technique of your invention be extended to 
other related fields? How ? 

Any collaborative facility could be employed in various means to execute a 
WebReview- like process. The advantages of WebReview are the centralized 
collection of information as it is generated to guide the collaboration and .the 
persistence of iriformation. 
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Similar current practices for document review involves distributing a "master 

copy" of a document which is then individually annotated and returned to the 

distributor. The distributor then collects the comments into a hew version of the 

"master document" arid may redistribute the new version for iterative review 

preparation. The advantagies pf the WebReview concept are the immediate 

avai lability of pther*s comments and the automation of the. comment: gatiiering aiid 

organization^ 

The general collaborative facility could be api^lied to any suitable item to be 
collectively inspected or reviewed by a groups The advantage of providing group 
commerits during the individual preparation jprocess is applicable to more than 
simply source code inspectioris. Any doeumerit which can, be fully described 
using network facilities could be reviewed/inspected, iisingisimilar^i^^ the 
preferred embodiment given. 

;c. Which features arc believecl to be new ? 

The application of network-based information gathering^^and dissemination to ihe 
formal, structured process of inspection of source code is not knpyvn to be applied 
at this time, 

d. Set forth the preferred embodiment for your invention. 

There are two elements to the preferred embodiment of WebReyiew at this tinie. 

1. The preparation facilities accept a collection of source code and generates 
formatted HTML pages with line nunibers linked to a comment entry form * 
Also:prepared is a table of contents for the entire source code file collection^ 

2. Th& collaboration facility consists^ of a Perl program executing as a CGI 
(Common Gateway Interface) extension to .the Apache web server: As 
collaborators enter their comments into the remark entry forrtL, the CGI data is 
passed to the Perl program which validates the form of information and 
records the remarks in the central review data store. Another element of the 
same CGI program provides for retrieval of previously stored information, 
possibly restricted to a particular file or set of files (inspection elements), a 
particular user's comments, both restrictions together, or all stored information 
at the collaborator's discretion. Each entered remark is hyper-linked to the 
specific item (prepared file and line number) to which it applies. 



Witness: 
Date: 
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THIS SECTION FOR iPD USE ONUV 



Rg<aglPT PATg STAMP 

J UN C » ' 



SI&MENS DOCKET JjnTA f^) \ \ 

IP ATTORNEY /=&^/V 



1 . TnU Wd»Hcylcw — electronic N^worfc collaborative Inspecilan and review .f^cUUy for Boffcware 

2. f»y RP05E AND PROEABUB in£U> OF USE OF TWB iNVENTfON 

Tliis faclltty prDvf>d«9 for ealtabcrratlvse inspectioa smd rcvtew of s«mre« co<l« u^Utifc im HTTP server to |>rvviilt: B<nccs5 to several reviewers. Reviewers can 
conniieat. q^cslUm, and idcntiry errors in cHa reviewed code to Che server. The senrer then dislHtsutes the collected informatfon to all reviewers. 

3. PLANNED USE IN PRODUCTS; USB OUTSIDE COMPANY. DEMONSTRATION. DISClX>5URe. OR PUBUCATION OF THE INVENTION (GfVE 
DATES) 

This facility can be used Immediately to imp^i^ve cfCeiezicar of software deweJopmeat processes. 

XJST AIX WRITTEN DESOUPTlONS OP THE INVENTION DESGRlBED IN ENOINEERIKO NOTEBOOK NO. PQS. ____ ) 

None* to date 

5. DATECS) INVENTION, W AS CONCEIV ED . Redacted DATECS) INVENTION WAS EXPLAINED TO WrTNESS(ES> 



WebRevlew wast conceived and cvptained on or around Redacted Cstatws to W. Howe— Supervisor) 

DATE(S) EMBODIMENT'S) OF THE IN VENTIpN WAS CONSTRUCTED 
%Veb Review was developed over ihe period Qrom |^Q^QI^(g^ to May 31, 2001. 

DATECS) EMBODIMENT<S) OF THE INVENTION WAS TESTED 
Webftevlew was dcmo^trated and appUed infOTinally by developers May 20» 2001 to May 31» 2003 (e-msft fknm Jeff Crlpe to reviewers of 

6. ATTACHED IS A DETAO-BD DESCRIPTION COMPRIStN Q 3 PACES 
6. ATTACHED IS A DETAtt^ED DBSCTRIPTION COMPRISINGL- 
T, INVENTOR 



code) 



PERSONAL INFORM ATfONi Mr. M MfS. I 1 M». I 1 
FULL NAME Mark J. Planagan 
M>l>KBSS B73S Indian River lUxn 

BoyntoB Betfcht-Florlda, 334S7 

Cmz^OF USA 
COMPANY INFORMATION: 

N A MH Siemens Inf orma tion& COiasmiiueation N«twBi4cs 

DfvrS ION END Bnterprise Svritefains NeCworlss 
ADDRESS SSOOBrotecaSouodmvd. 

eoco Hilton, ri^ 3S4S1 
TBU NO. 561*423*1948 

socsECNO. Redacted 

DATE ^ii^Z^^ 



PACES 

8- CO«lNVE?nt>Rt XFANV 

PERSONAL INFORMATION: 

PUIhLNAMB 

ADDRESS 

CmZJEN OF 

COMPANY ZNFORMATtON: 

NAME 

DIVISION 

ADDRESS 

TEL. NO* 

socsec.no. 

DATE 



Mf- C J Mn. I J Ms. t 1 



SIGNATURE- 



9. WfTNESS; Wtmessed aod u nder stood by: 

NAME filsLisr"/ fsj ^\^'rc^H^f^ 
TBUNo, C<^^H ) — c^c-^<Sr 

DATE f f O I 



SIGNATURE^ 



SIONATURB 




COlwtPANY. INFORMATION: 
NAME 
ADDRESS 



CUse en eddltkmal fonn for s 



: oo-f nveatpr*) 



THZS INVENTION DISCLOSURK IS COMPANY PROPSRTY A1«D XS AVAXtASX^ OWUY TO AUTHORXESD PfiRBOKS . THB tX3mWt& ARiS 
COHPXDSNTXAl. AKD ARB NOT TO BS OZSCLOSBD ANY MAMMER, 2N WMOt^ OR »ART. EXCEPT IN ACCORDANCE WXTM 

BSTAai«XSHSO AFFROVAI. PROCESCIRES . 
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SIEMENS CX>^nFlr>HNTIAL 
Invention Oisclosure Form Supplement 



1 . Title : WebReview 

2. Ab§t2:ict: 

WebReview provides for inspection and review of software products (source code) 
using a collaborative, interactive facility. 



3 . B ackground Information 

a. What is the problem sOlvftd bvvQur invention? 

Code Inspections are an integral part of our software development processes. 
Curretiay, a static packet is created by the author or moderator assigned to the 
review which is distributed to all reviewers. After a suitable review period, a 
meeting is held wheie an assigned developer reads the code out loud and 
reviewers make comments and identify errors or problems. These are recorded by 
the assigned moderator and corrected by the author, completing the review 
process. 

b. What lecl^r^iaues prior to vour inventi o n were used to perform the functior^ of yquf 
invention ? 

1) Manual inspections — generally on paper* in accordance with software 
developnient process giJideHnes. 



2> 

c. What ai^ th e disadvantages of these Orior techniques? 

The review/inspection meeting(s) generaDy take a great deal of time, current 
inspection guidelines use a metric of 100^125 lines of code per hour of meeting 
with similar times required for preparation and correction times. 

d. What are t h e advantages of vour invention over the Prior tcchniqt^p^ ? 

On-line review, with collaborative collection of information should be much more 
efficient- Reviewers receive information from each oth^ during the preparation 
process so the review meeting should be much shorter. Since the comments are 
available immediately, the author and moderator can a^w on the clarity and 
correctness of most comments and eliminate the need for discussion. 




X>ate: 
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SiTTiilar current practices for documfimt review involves distributing; a ^'master 
copy" of a document which is then indt vidually annotated and returned to the 
distributor. The distributor then collects the comments into a new version of the 
"master document'* and may redistribute the new version for iterative review 
preparation. The advantages of the WebReview concept are the immediate 
availability of other*s comments and the automation of the comment gathering and 
organization. 

The general collaborative facility could be applied to any suitable item to be 
collectively inspected or reviewed by a group. The advantage of providing group 
comments during the individual preparation process is applicable to more than 
simply source code inspections. Any document which can be fiilly described using 
network facilities could be nsviewed/inspected using similar facilities to the 
preferred embodiment given. 

c. Which features are believed to be new ? 

The application of network-based information gathering and dissemination to the 
formal, structured process of inspection of sotirce code is not known to be applied 
at this time. 

Set forth the prefenped embodiment for vour invention . 

There are two elements to the pxeferced embodiment of WebReview at this time. 

1. The preparation facilities accept a collection of source code and generates 
formatted HTML, pages with line numbers linked to a comment entry form. 
Also prepared is a table of concents for the entire source code file collectEOii. 

2- The collaboration facility consists of a Perl program executing as a CQl 
(Common Gateway XntCTface) extension to the Apache web server. As 
collaborators enter their comments into the remark entry form, the CGI data is 
passed to the Perl program which validates the form of information and 
records the remarks in the central review data store. Another element of the 
same CGI program provides for retrieval of previously stored information, 
possibly restricted to a particular file or set of files (inspection elements), a 
particular user's comments, both restrictions together, or all stored information 
at the collaborator's discretion. JBach entered remark is hyper-linked to the 
specific item (prepared file and line number) to which it applies. 



Witness 



Date: j I j (? \ 
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